package com.clock.shop.mapper;

import com.clock.shop.domain.ShopCoupon;
import com.clock.shop.domain.dto.UserCouponDTO;

import java.util.List;


/**
 * 优惠券Mapper接口
 * 
 * @author ruoyi
 * @date 2024-10-11
 */
public interface ShopCouponMapper 
{
    /**
     * 查询优惠券
     * 
     * @param couponId 优惠券主键
     * @return 优惠券
     */
    public ShopCoupon selectShopCouponByCouponId(Long couponId);

    /**
     * 查询优惠券列表
     * 
     * @param shopCoupon 优惠券
     * @return 优惠券集合
     */
    public List<ShopCoupon> selectShopCouponList(ShopCoupon shopCoupon);

    /**
     * 新增优惠券
     * 
     * @param shopCoupon 优惠券
     * @return 结果
     */
    public int insertShopCoupon(ShopCoupon shopCoupon);

    /**
     * 修改优惠券
     * 
     * @param shopCoupon 优惠券
     * @return 结果
     */
    public int updateShopCoupon(ShopCoupon shopCoupon);

    /**
     * 删除优惠券
     * 
     * @param couponId 优惠券主键
     * @return 结果
     */
    public int deleteShopCouponByCouponId(Long couponId);

    /**
     * 批量删除优惠券
     * 
     * @param couponIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteShopCouponByCouponIds(Long[] couponIds);

    /**
     * 查询用户个人优惠券列表
     * @param userCouponDTO 接收查询参数实体
     * @return 优惠券集合
     */
    List<ShopCoupon> selectUserCouponList(UserCouponDTO userCouponDTO);

    /**
     * 查询用户可兑换优惠券列表
     * @param shopCoupon 优惠券
     * @return 可兑换优惠券列表
     */
    List<ShopCoupon> selectUserCanExchangeCouponList(ShopCoupon shopCoupon);
}
